home *** CD-ROM | disk | FTP | other *** search
/ SGI Enlighten DSM 1.1 / SGI EnlightenDSM 1.1.iso / irix5x6x / admin.z / admin / help / C / online0520.hlp < prev    next >
Text File  |  1998-06-30  |  13KB  |  375 lines

  1.     New User Template Add
  2.  
  3.     Enlighten supports the concept of user account templates. You can
  4.     use these templates to facilitate the creation of new user accounts.
  5.  
  6.     Each template specifies the defaults Enlighten will use when it adds
  7.     a new user to the system. If you leave a field blank when you're
  8.     adding a new user account, Enlighten will substitute the default
  9.     parameters set-up for that field.
  10.  
  11.  
  12.     Fields
  13.  
  14.     The window has the following fields:
  15.  
  16.     Template Name
  17.  
  18.     Use this field to specify the template's name. See USER ACCOUNT MACROS
  19.     below for a detailed explanation of how to use macros.
  20.  
  21.     Description
  22.  
  23.     Use this field to briefly describe this template's purpose. This is
  24.     used by other commands, such as Session Preferences and Adding
  25.     Users, when you want a pop-up list of available templates displayed.
  26.  
  27.     Login Name Macro
  28.  
  29.     Use this field to specify a macro for the user name. 
  30.     See USER ACCOUNT MACROS below for a detailed explanation of how
  31.     to use macros.
  32.  
  33.     Home directory
  34.  
  35.     The Home directory field specifies where the user's start-up
  36.     directory is attached. Most systems will use /usr or /home as the
  37.     default parent directory. Each user will have their own directory
  38.     created under the default home directory, e.g. /usr/charlie.
  39.     Enlighten stores /usr as the default HOME directory unless you
  40.     change this field. If the default Home Directory is /eng, and the
  41.     login name of the new user account is fred, the name of the HOME
  42.     directory Enlighten generates would be:
  43.  
  44.         /eng/fred
  45.  
  46.     You can also use macros in this field. 
  47.     See USER ACCOUNT MACROS below for a detailed explanation of how
  48.     to use macros.
  49.  
  50.     Startup Shell
  51.  
  52.     The Shell is a program that acts as a translator between the user
  53.     and the UNIX operating system. There may be several standard shells
  54.     on a system, including the C Shell, the Bourne Shell, the Korn Shell
  55.     and the restricted Bourne, C and Korn Shells. Each shell has its own
  56.     start-up executable program as shown below.
  57.  
  58.         Bourne Shell /bin/sh
  59.  
  60.         Restricted Bourne Shell /bin/rsh
  61.  
  62.         C Shell /bin/csh
  63.  
  64.         Korn Shell /bin/ksh
  65.  
  66.         Restricted Korn Shell /bin/rksh
  67.  
  68.         Other user defined
  69.  
  70.     Enlighten uses the Bourne shell as the default shell in this field
  71.     (/bin/sh). The number of standard shells available for this field
  72.     depends on your system. Click on the arrow button to display a pick
  73.     list of available shells.
  74.  
  75.     Primary Group Name
  76.  
  77.     Every user account must be assigned to at least one User Group. The
  78.     User Group is part of the UNIX security system; each user group has
  79.     specific read, write, and execute privileges associated with every
  80.     file created on the system.
  81.  
  82.     Enter the Primary Group Name for this template. You can also click
  83.     on the arrow button for a pick list of defined User Groups and make
  84.     your selection from there. If you enter a Primary Group Name which
  85.     does not exist, Enlighten will prompt for a correct Group Name when
  86.     it tries to create the user.
  87.  
  88.     Additional Groups
  89.  
  90.     You can use this field to put the user in additional user groups.
  91.     This will effectively give the user more group privileges beyond
  92.     those set in the primary user group. Enter the names of the user
  93.     groups to which the user should also belong. If you are using
  94.     multiple entries, leave a blank between each entry.
  95.  
  96.     You can also click on the arrow button for a pick list of defined
  97.     User Groups. Select the User Groups and click on the Apply button to
  98.     import them.
  99.  
  100.     UID Range from ... to
  101.  
  102.     You can use these fields to define a UID range for the template.
  103.     This range is used if you set the next field to have a UID
  104.     automatically generated for the user.
  105.  
  106.     Automatically generate unique UID if it's missing
  107.  
  108.     Each user account created must have a UserID number. Use this toggle
  109.     to choose whether a unique UID is generated for a new user if you
  110.     don't specify one during creation of the new user account. The
  111.     default is not to (No).
  112.  
  113.     Default Password
  114.  
  115.     The password is part of the UNIX security system. Each user must
  116.     have a password. If you make the password the same as the user
  117.     login, the user can then reset the password to one of his or her own
  118.     choice. Don't use passwords such as spouse names, pet names, or
  119.     addresses, they are easy for another user to guess.
  120.  
  121.     You can also use macros in this field. 
  122.     See USER ACCOUNT MACROS below for a detailed explanation of how
  123.     to use macros.
  124.  
  125.     Note: If the entry in the password field is not long enough, an
  126.     error message will be displayed when you try to add this user
  127.     account.
  128.  
  129.     Password Expiry
  130.  
  131.     For systems that support password aging, this optional field
  132.     contains the time when the password will expire. Once a password has
  133.     expired, the system will force the user to change their password the
  134.     next time they login to the system.
  135.  
  136.     If this field is left blank, the appropriate default parameter will
  137.     be used. If no default is set in the User Add window (when you're
  138.     adding a user), password aging will be turned off for that user. 
  139.  
  140.     See TIME FORMATS below for a description of supported time formats.
  141.  
  142.     Password Life Span
  143.  
  144.     In conjunction with the previous field, this field defines the
  145.     minimum period of time which needs to elapse before the user can
  146.     change his or her password. 
  147.  
  148.     See TIME FORMATS below for a description of supported time formats.
  149.  
  150.     Note: You can change the user's password at any time by using the
  151.     Password button in the User Configuration window. 
  152.  
  153.     Minimum Password Length
  154.  
  155.     Each user account has a password associated with it. This password
  156.     is defined when the user account is created and may be changed any
  157.     time thereafter. This field accepts a numeric entry defining the
  158.     minimum length that the (new) password must be whenever the password
  159.     is created or modified. You can also use the counter buttons on the
  160.     right to increment or decrement the number shown.
  161.  
  162.     Note: If you set this value to zero, the user does not need to use a
  163.     password when logging into the system. The user will still be asked
  164.     by the system to enter a password, however. The user can then log in
  165.     by hitting the <return> key.
  166.  
  167.     Require user to have a password
  168.  
  169.     It may be necessary sometimes for a user to have no password. By
  170.     default, Enlighten forces each user to have a password. To configure
  171.     user accounts with no password, set this toggle to No.
  172.  
  173.     Mail Alias
  174.  
  175.     This field specifies the default mail alias the account will use. An
  176.     alias designates a short name as the substitute for the full
  177.     pathname for a particular user or group, e.g., laura for
  178.     laura_lombardo@desk.com.
  179.  
  180.     You can also use macros in this field. 
  181.     See USER ACCOUNT MACROS below for a detailed explanation of how
  182.     to use macros.
  183.  
  184.     Mail Lists
  185.  
  186.     This field specifies which mailing lists will be updated to include
  187.     this user account. A mail list defines a group of people under one
  188.     alias, so sending mail to that alias will distribute a copy everyone
  189.     on that list. If you are using multiple entries, leave a blank
  190.     between each entry. You can also click on the arrow button for a
  191.     pick list of defined Mail Lists and make your selection(s) from
  192.     there.
  193.  
  194.     Buttons
  195.  
  196.     The New User Template Add window has the following buttons:
  197.  
  198.     Add
  199.  
  200.     Once you've specified all the values for the new user template,
  201.     click on this button to save it. Then you can access this template
  202.     when you are setting your session preferences or adding users.
  203.  
  204.     Clear Fields
  205.  
  206.     Click on this button to clear the existing choices in all fields.
  207.  
  208.     Cancel
  209.  
  210.     Click on this button to close the window without making any changes.
  211.  
  212.  
  213.     TIME FORMATS
  214.  
  215.     There are several fields throughout the Enlighten product where you
  216.     can specify a date/time format. For each of these fields, you can
  217.     specify the date and/or time period in two ways: absolutely or
  218.     relatively.
  219.  
  220.     The first is as a static period, where the period entered is the
  221.     absolute period used in the search. This is the only way to search
  222.     for a combined date/time format. To look for a file created since
  223.     May 10, 1996 at 12 noon, you could use the entry: May 10 96 at
  224.     12:00.
  225.  
  226.     The second is a relative period, where the period entered is set
  227.     against the current system clock time and then applied during the
  228.     search. This is strictly a time OR date format, e.g., 2 seconds or 1
  229.     month. To find users who have been logged in during the last three
  230.     days, you could use the entry: 3 days.
  231.  
  232.     Either way, the format is case-insensitive. For example, you could
  233.     use JAN, Jan, or jan as the abbreviation for the month of January.
  234.     This appendix shows all the BNF time measurements in initial caps
  235.     (e.g., Jan or January, 2 Sec or 2 Seconds, etc.).
  236.  
  237.     Some typical uses of the static format in a Date search field are:
  238.  
  239.     Absolute: 15 1996 (defaults to the current month)
  240.  
  241.         Jan 1 97
  242.         July 4 (defaults to the current year)
  243.  
  244.     Some additional uses of the absolute format in a Time search field
  245.     are:
  246.  
  247.         June 15 at 3 PM (defaults to the current year)
  248.         June 16 at 2AM (defaults to the current year)
  249.         June 17 96 at 15:31
  250.         18 at 9:31:14 AM (defaults to current month AND year)
  251.  
  252.     Some typical uses of the relative format in a Date search field are:
  253.  
  254.         Relative: 1 second
  255.  
  256.         5 Min
  257.         1 day
  258.         2 weeks
  259.         1 Year
  260.  
  261.     The rest of this appendix defines the time formats you can use
  262.     whenever you fill in a date and/or time field.
  263.  
  264.  
  265.  
  266.     USER ACCOUNT MACROS
  267.  
  268.     You can use macros to help initialize the form fields when you
  269.     create a User Account. 
  270.  
  271.     The following types of fields accept macros:
  272.  
  273.     + Login Name
  274.     + Home dir.
  275.     + Password
  276.     + Mail Alias
  277.  
  278.     Format
  279.  
  280.     A macro has the following format:
  281.  
  282.         %<Modifiers><Macro Name>
  283.  
  284.     Modifiers
  285.  
  286.     <Modifiers> are optional (you can define them multiple times). You
  287.     can use the <Modifiers> to specify only specific parts of the field,
  288.     such as the first letter of the field, or to manipulate and convert
  289.     the given input.
  290.  
  291.     A modifier has the following format:
  292.  
  293.  
  294.     [<Converter><Range>]
  295.  
  296.     where <Converter> is one or more of the following characters:
  297.  
  298.         l - Convert the resulting string to lower case
  299.         L - Same as `l'
  300.         u - Convert the resulting string to upper case
  301.         U - Same as `u'
  302.         s - Do not include SPACEs
  303.         S - Same as `s'
  304.         _ - Replace SPACEs with underscores (_)
  305.  
  306.     and the <Range> applies to the complete string in the field (by
  307.     default). Or you can apply a range to a specific word in the input
  308.     string.
  309.  
  310.     Consequently, a <Range> has the following format:
  311.  
  312.         $<word number><Character Range>
  313.  
  314.     where <word number> shows the word's sequence in the string (this is
  315.     optional). The first word would be addressed as $1, the second word
  316.     as $2, and so on. You can also use $0 to address the first word.
  317.  
  318.     <Character Range> is a comma separated list of character ranges in
  319.     the form. If you specify a <word number>, you must first use a comma
  320.     (`,') in the range list.
  321.  
  322.     The character range itself has the following format:
  323.  
  324.         <start char>-<end char>
  325.  
  326.     where <start char> and <end char> are character numbers. You can
  327.     omit one end of the range to signify the "start of string" and "end
  328.     of string" respectively. Ranges which go beyond the end of the
  329.     string are truncated to match the string.
  330.  
  331.     Macro Name
  332.  
  333.     <Macro Name> is one of the following characters:
  334.  
  335.         g - replace with the users' GID
  336.         u - replace with the users' UID
  337.         G - replace with the users' group name
  338.         U - replace with the users' login name (username)
  339.         R - replace with data from the users' Real Name field
  340.         O - replace with date from the users' Office field
  341.         T - replace with date from the users' Telephone field
  342.  
  343.     Examples
  344.  
  345.     These definitions make more sense when they are viewed as examples.
  346.     Assume for the following example, the following data is true:
  347.  
  348.         Real Name: Thomas Kraus
  349.         Login Name: tmk
  350.         UID: 302
  351.  
  352.     You could then define the following macros and see the following
  353.     substitutions.
  354.  
  355.         Field Name   Macro               Value
  356.         -------------------------------------------
  357.         Home Dir     /home/%U           /home/tmk
  358.         Password     %U-%u              tmk-302
  359.         Mail Alias   %[u$1]R_%[u$2]R    THOMAS_KRAUS
  360.         Login Name   %[l$1,1][l$2,-6]   tkraus
  361.  
  362.     Some explanations:
  363.  
  364.     /home/%U Create the directory /home/<login name>
  365.  
  366.     %U-%u Get the User name and add the UID (separated by a dash)
  367.  
  368.     %[u$1]R_%[u$2]R Get the first word of the users' real name and add
  369.     the second word of the user's real name (separated by an
  370.     underscore). Convert both strings to upper case.
  371.  
  372.     %[l$1,1][l$3,-6]R Take the first letter of the users first name and
  373.     the first six letters of the users' last name. Convert both strings
  374.     to lower case.
  375.